Greptile Summary

This PR introduces a typed Enum DTO (Utopia\Platform\Enum) that can be attached to Action::param() calls to carry SDK enum metadata for whitelist-backed parameters. The enum field is stored on both $this->params and $this->options, and is forwarded to Route/CLI/Worker hooks via the three init* methods in Platform.php.

• New Enum DTO — final readonly class with optional name, map, and exclude fields; fully nullable so consumers can attach partial metadata as needed.
• Action::param() extended — ?Enum $enum = null appended as a named parameter, maintaining full backward compatibility with all existing positional and named-argument call sites.
• Platform forwarding — all three initHttp, initTasks, and initWorker paths pass enum: through to the underlying hook, coordinated with bumps to utopia-php/servers 0.4.1, utopia-php/http rc3, utopia-php/cli 0.23.4, and utopia-php/queue 0.18.4 that add matching support.

Confidence Score: 5/5

Safe to merge — the change is a backward-compatible addition of an optional parameter with no effect on existing call sites or runtime validation logic.

The Enum DTO is a pure data carrier with no side effects; Action::param() remains fully backward-compatible; the Platform forwarding paths are consistent across all three init methods; and the updated dependency versions are stable patch or RC releases. The only gap found is in test coverage, which does not affect production behavior.

No files require special attention beyond the minor test coverage gap in tests/e2e/HTTPServicesTest.php.

Important Files Changed

_{Reviews (8): Last reviewed commit: "Update Utopia server dependencies" | Re-trigger Greptile}